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Introduction 


The HP E2450A Symbol Utility provides you with a new way to view 
your logic analysis data. The Symbol Utility maps trace data onto 
meaningful, symbolic names. The symbols can include variable nam.es, 
procedure or function names, and source file names and line numbers. 
The linkage between the symbol names and the trace data values 
comes from one of two sources: 


• Object Module Format (OMF) files generated by your compiler and 
linker, or 

• ASCII files that you create with a text editor 

Using the symbol utility, you have two new capabilities: 


• you can view symbols from OMF files in a logic analyzer state listing 

• you can use the OMF sjnnbois as trigger terms in a logic analyzer 
trigger specification. 


We assume that you are familiar with the operation of your logic analyzer. If 
not, refer to the Logic Analyzer Training Kitfor information on how to use the 
logic analyzer interface or the appropriate User's Guide for details on the 
system menus and functions. 


Refer to your software tool documentation for information about how to 
generate OMF files during compilation and linking. 


Equipment Required 

• one HP E2450A Symbol Utility disk 

• either an HP 1660-series logic analyzer, an HP 1670-series logic analyzer, 
or an HP 16500B or 16500C logic analysis mainframe and one logic 
analyzer meaurement module, such as an HP 16550A timing analyzer 
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Supported Symbol File Formate 


Supported Symbol File Formats 

The HP E2450A will support OMF files in the following formats: 

ELF/DWARF This OMF is a portable format consisting of ELF 
(Executable and Linkable Format) and DWARF (Debugging Information 
Format) for various processors, including Intel 80960, PowerPC, and 
MIPS. 

GPA The General-Purpose ASCII file format, which can be used to 
provide symbols for an Object Module Format which is not explicitly 
supported. See the "General-Purpose ASCII Symbol File Format" section 
in the "Features and Functions" chapter for more details. 

HP-MRI IEEE-695 The OMF produced by HP and MRI cross-compilers 
and cross-assemblers. This format is fully supported by the Symbol 
Utility’s IEEE-695 reader. 

IEEE-695 This OMF is usually produced by language tools for non-Intel 
microprocessors. Some language tools which claim to output this format 
may deviate from the IEEE-695 standard in ways which make the OMF 
file unreadable by the Symbol Utility’s reader. 

OMF286 This OMF is produced by language tools for Intel 80x86 series 
and Pentium microprocessors running in real and/or protected mode. 

The supported OMF286 file types are Single-task Loadable and 
Bootloadable. 

OMF386 This OMF is produced by language tools for Intel 80x86 series 
and Pentium microprocessors running in real and/or protected mode. 

The supported OMF386 file types are Loadable and Bootloadable. 

OMF86 This OMF is produced by language tools for Intel 80x86 series 
and Pentium microprocessors running in real mode only. 

OMF96 This OMF is producted by language tools for the Intel 80196 
family of processors. 

TI-COFF This OMF is produced by language tools for Texas 
Instruments microprocessors. 
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In This Book 


This book provides a detailed description 
of the features of the HP E2460A Symbol 
Utility. 

The book is divided into the following 
chapters: 

Chapter 1 describes how to install the 
software on your HP 16500B/C logic 
analysis system or HP 1660C/CS-series or 
HP 1670A/D-series logic analyzer. 
Chapter 1 also describes how to locate 
the menus associated with the Symbol 
Utility. 

Chapter 2 describes how to use the HP 
E2450A to perform common tasks like 
triggering on an OMF symbol. 

Chapter 3 describes the features and 
functions of the HP E2450A Symbol 
Utility. It also provides a detailed 
description of the General-Purpose ASCII 
file format. 
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Getting Started 



Getting Started 


See Also 


This chapter describes how to instaE the HP E2450A Symbol Utility 
software on the hard disk of the logic analyzer. Instructions are 
included on how to locate the menus associated with the HP E2450A 
Symbol Utility. 

Once the Symbol Utility is installed, you can use the OMF Symbol 
Load menu to load Object Module Format (OMF) symbol files into the 
analyzer. Once you have loaded the files, you can view the symbols in 
the Listing and Waveform menus. You can use the OMF Symbol 
browser menu to create trigger conditions for your logic analyzer. 


The Logic Analyzer Training Kit for information on how to use the 
logic analyzer interface. 

The logic analyzer’s User’s Guide for information on the features and 
functions of the logic analyzer you are using. 
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Installing the HP Logic Analyzer Software 


Table 1 



The HP E2450A Symbol Utility software, the HP Logic Analyzer 
System software, and the HP State Analyzer module (HP 16500B 
only) software m.ajor version num.bers m.ust m.atch. You can find the 
operating system version number under System Test. See the 
software version number example in table 1. 


Example of Acceptable Software Version Numbers 


Product Software Version 

HP 16500B System Software (SYSTEM) 3.06 

HP 16555A Module Software (SYS_034) 3.10 

Symbol Utility Software for HP 16500B (OPT_032) 3.04 

HP 16500C System Software (SYSTEM) 1.00 

HP 16550A Module Software (SYS_032) 1.00 

Symbol Utility Software for HP 16500C (OPT5_032) l.(W 

HP 1671D System Software 1.00 

Symbol Utility Software for HP 1670 1.01 


The HP E2450A Symbol Utility ships with the benchtop analyzers. 

• If you need to update the HP 16500 system and module software, 
copy the files from the flexible disks to the /SY'STEM subdirectory on 
the logic analyzer’s hard disk. Then, reboot the HP 16500. 

• If you are updating the HP 1660C/CS-series or HP 1670A/D-series 
operating system, copy the update from the flexible disks to the flash 
ROMs. Updates can be ordered from your HP Sales Office. 

a Go to the System Utilities menu. 

b Select the button labeled Update FLASH ROM. 

c Insert the first flexible disk and follow the onscreen instructions. 

The flexible disks now serve as backup copies for the files on the hard 
disk or in flash ROM. For more information about copying a file or 
updating the logic analyzer’s system software, see the appropriate 
logic analyzer User’s Guide. 
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Getting Started 

To Install the Symbol Utility Software 


1 


2 


CAUTION 


When the Symbol Utiltity 
is loaded on a benchtop 
analyzer, it shows up 
here. 


To Install the Symbol Utility Software 

The first time you load the symbol utility, the logic analyzer must read 
it from the flexible disk at power-up. To install the Symbol Utility 
software on the HP logic analyzer, take the following steps: 

With the instrument turned off, insert the flexible disk labeled 
"HP E2450A Symbol Utility sofiware" into the flexible disk drive on 
the logic analyzer. 

Tiim on the instrument. 

The software loads automatically if you insert the flexible disk prior to 
turning on the instrument. The software takes a few minutes to load. 

Proceed only when the light on the front of the flexible disk drive stops 
blinking. If you proceed before the li^t goes out, the installation will be 
incomplete and you wiU have to start the process over at step 1. 

In the System Configuration menu (System External I/O menu on benchtop 
logic analyzers) menu, the Symbol Utihty should now appear in the Options 
display. If it does not appear, repeat steps 1 and 2. 


f System External IJ 




Connected To: 


X 

X-Hind£ 

^ Settings ] 

1 1 1 
Controller 


^Disconnect ] 


i 


136 Channels 

70 HHz STATE 

250 tlHz TIMING 

512k Samples 



SVneOL UTILITY 
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Getting Started 

To Install the Symbol Utility Software 



Select this field and 
choose Symbol 
Utility or Symbols 


Select Cancel to 
cancel the 
installation software 


3 Select the Module field, in the top left comer of the display, then 
choose Symbol Utility fi:“om the pop-up menu. 


^ Symbol Utility~^ 


Hon to use the QHF Symbol Utility 


1. Select 
file i n| 

1oaded 

To V i ew| 
the lab| 

To use 
ment fi 
"OMF SJ 
the topf 


See Chapte 


The Symbol Utility Software booted from the 
flexible drive. If you want to install this 
software onto the internal hard drive select 
Install, otherwise select Cancel. 

Note: Installation will take approximately 
5 minutes. 


D C 


priF symbol 


I assign- 
witch to 
field at 


Specify Database 




Select Install to install 
the software 


This figure shows the HP 16500C logic analj^er menu. The benchtop logic 
analyzers are similar. 

K you are using a benchtop logic analyzer, the Install/Cancel menu does not 
appear. The Install button appears to the right of the Specify Database button. 

5 Select Install to copy the files onto the hard disk drive, or select 
Cancel to cancel the operation. 

CAUTION proceed until the light on the front of the flexible disk drive stops 

blinking. If you do proceed the installatiori will be incomplete and you wiLL 
_ need to start over at step 1. 

histaliation requires about 5 minutes to complete. Once the installation is 
complete, you can remove the Symbol Utility disk from the flexible disk drive 
and store it as a backup. The Symbol Utility wiU load whenever you turn on 
the logic analyzer. 

If the installation does not complete and the error messages do not indicate a 
disk error, the logic analyzer may not have enough memory to load the 
Symbol Utility software. To install the software successfully, increase your 
logic analyzer’s available memory either by uninstalling other options or by 
purchasing additional memory. 

See Also Chapter 2, "Using the Symbol Utility," for how-to information. 

Chapter 3, "Features and Functions," for detailed descriptions of the menus 
and fields that are associated with the Symbol Utility. 
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Getting Started 

To Access the Symbol File Load Menu 


Select this field and 
choose Symbol Utility 


To Access the Symbol File Load Menu 

To begin working with symbols in the logic analyzer, you need to load symbol 
files into the system. The OMF Symbol Load menu is used to do this. There 
are two ways to access this menu. 

Method 1: Using the Module Field 

Select the Module field in the top left comer of the display. 

K you are working with system-level menus, this field wiU say "System." 
Choose Symbol Utility from the pop-up. 


System 


Symbo1 Utility 


Intermodule 


100/500t1Hz Lfi C 


Options 


SVMBOL UTILITV 


500 tIHz TiniNG m 


MB Data ftcq E 

II 


2nB Date Acq[[ f 
riASTER 





Icommunications) 


Ethernet 
H HP IB 

RS-232C 


Printer Setup ) 


This picture shows an HP 16500B. On the benchtop logic analyzers, "Symbol 
Utility" appears as "Symbols." 
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Select this field 


See Also 


Getting Started 

To Access the Symbol File Load Menu 

I 


3 Select the Specify Database field in the Symbol Utihty menu. 


( Symbol IJtilitij~^ 


How to use the 0I1F Symbol Utility 

1. Select the "Specify Database" field below and load an OflF symbol 
file into an analyzer module label (flDDR, for example). 

2. Access the analyzer module into which the OflF symbol file was 
1oaded. 

To view OflF symbols in the Trigger/Trace or Listing menu' Set 
the label base to "Symbol". 

To use OMF symbols in a trigger term: Select the term's assign¬ 
ment field to raise the "User Symbol Table" pop-up. Switch to 
"OMF Symbol Table" by selecting the "User Symbol Table" field at 
the top of the pop-up and choosing "OMF Symbol Table". 

See Chapter 2 of the HP E2450A Users Guide for more information. 


Specify Database 



The Symbol Load menu appears. Use this menu to load an Object Module 
Format (OMF) file into the HP 16500 system. 



Chapter 2, "Using the Symbol Utility," for information on how to load a 
symbol file. 
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Getting Started 

To Access the Symbol File Load Menu 


Method 2: Using the Symbol Field in the Format Menu 
1 Go to the Analyzer Format menu. 

K you are using an HP 16500, choose the analyzer module that you want to 
use with the Symbol Utility. 


2 In the Format menu, select the Symbols field. 



3 In the Symbols pop-up, select the lai^e field at the top of the display. 
Choose OMF Symbol Table from the pop-up. 
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See Also 


Getting Started 

To Access the Symbol File Load Menu 

I 


The OMF Symbol Load menu appears. Use this menu to load an Object 
Module Format (OMF) file into the logic analyzer. 

Chapter 2, "Using the Symbol Utility," for information on how to load a 
symbol file. 




1 ( OMF Symbol Table ) 


OMF File! 

.J 

■ Drive! [ Hard Disk ) 

Label: ( ADDR ] 

( Section Relocation ] i1otlule:( lOO/SOOtlHz Lfl C ] 


[current Loaded Files ] [ Load ] [ Done ] 




OMF Symbol Load Menu 
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Getting Started 

To Access the Symbol Browser 


To Access the Symbol Browser 

1 Go to the Analyzer Trigger menu. 

2 Set the base for the label that you want to work with to "symbol." 

3 Select a trigger term corresponding to the label and pattern term that 
you want to use. 



4 In the Symbol pop-up menu, select the large field at the top of the 
pop-up and choose OMF Symbol Table from the pop-up menu. 
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Getting Started 

To Access the Symbol Browser 



The OMF Symbol Browser menu appears. Use this menu to select an OMF 
symbol as a trigger term. 


( OMF Symbol Table ] 


ind 


D 


Context! 
Address; 


^ ftlign to 1 Byte ^ Offset by fxXXXXXxU 


CanceI ] ^ 


View Globsls and Locals 


J [ Done ] 


See Also 


Chapter 2, "Using the Symbol Utility," for mformation on 
symbol browser to set up trigger conditions. 


how to use the 
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Using the Synibol Utility 



See also 


Using the Symbol Utility 

To Generate a Symbol File 


To Generate a Symbol File 

In order to view symbols from your software in the Listing or Waveform 
menus of the logic analyzer, you need to create a symbol file in one of the 
formats that are supported by the HP E2450A Symbol Utility. If your 
language tools cannot generate an OMF symbol file which is compatible with 
the Symbol utility, you may create a symbol file in the General-Purpose ASCII 
(GPA) file format. 

1 Compile, assemble, and link your program using the "generate 
symbol file" option of your language tools. 

2 Transfer the DOS-formatted symbol file to the logic analyzer. You can 
put the file on a flexible disk, or use a LAN interface to transfer the 
file directly to the hard disk. 


If you need help creating OMF files, refer to your software tool documentation 
for information about how to generate OMF files during compilation and linking. 


"The General-Puipose ASCII File Format," in Chapter 3, for a complete 
description of the ASCII symbol file format. 

"Supported File Formats," in the Introduction, for a list of the symbol file 
formats that are supported by the HP E2450A utility. 
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Using the Symbol Utility 

To Load a Symbol File 


To Load a Symbol File 


1 Access the OMF Symbol Load menu. 

There are two methods available to access this menu. See "To Access the 
Symbol File Load meriu," in Chapter 1, for more information. 

2 Select the disk drive that contains the symbol file. 

3 Select the measurement module that you want to load the symbol file 
into. 

For the benchtop logic analyzers, the choice will always be "Analyzer." 

4 Select the Label field and choose the label that you want to map the 
OMF symbols to. 

Typically, you will use the ADDR label for your system address bus. 


Access the OMF 
Symbol load 
menu 



□fIF Sgmbol Table 


d 

OnF File: 

(_1 



Drive: ^ Hard Disk 



Label: ADDR ^ 

^ Section Relocation j 

nodule:i 

lOO/SOOriHz LA c 4 



1 Current Loaded Files j 

^ Load j 

j Done j 


Choose the diskdrive 
that contains the OMF 
file 


Choose the desired 
module and label 
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Using the Symbol Utility 

To Load a Symbol File 


5 Select the OMF File field. In the pop-up, turn the knob to highlight 
the desired file name. Select the Select field to choose the file. 



File Selection Menu 
Name File Type 



If necessary, use the knob and the Select field to choose a different directory. 

6 Select the Load field, then select Done. 










Using the Symbol Utility 

To Load a Symbol File 


The symbol file is loaded only into the measurement module you specified. 
You can load the same symbol file into several modules, and you can load 
several symbol files into one module or analyzer. 

When you load a symbol file, a database file is created by the logic analyzer. 
Database files have an extension ".ns". If your OMF file was loaded from the 
hard disk drive, the database file will appear in the same subdirectory as your 
OMF file. If your OMF file was loaded from, the flexible disk drive, the 
database file will appear on the hard disk drive in the same directory it was in 
on the flexible disk. The logic analyzer creates any necessary subdirectories 
on the hard disk. 


See Also 


'To Access the Symbol File Load Menu," in Chapter 1. 



Using the Symbol Utility 

To Display Symbols in the Trace List 


To Display Symbols in the Trace List 


1 Load the appropriate symbol file. 

2 Display the trace listing in the Listing menu of the logic analyzer 
module that you are working with. 


A ri ll 






ACC6SS InB 



Usting menu 

( 100/500nHz LA C ) ( 

Listing 1 ] (invasm Options] ( Print ] ( 

Run ] 


{ narkers 1 






[ Of r 







i L8bel> 

1 ADDR 1 



80A86 Inverse Assembly 



[ B8se>, 

1 Hex 1 

... 


Mnemonics/Hex 

□ [s^ 


0 

FFFFFFFO 

0 

JHP 

F000:E05B 

PAG 


A 

000FE058 

B 

JHP 

RAV_BN:D+OOOFOOBA 

PAG 


B 

OOOFOOB8 

A 

CLI 


PAG 




B 

CLD 




9 

OOOFOOBC 

C 

IN 

AL,#6A 

PAG 




E 

TEST AL,«0A 



1 16 

0000006A 

4 

xxxxxxOO i/o read 

PAG 


21 

00000001 

1 

xxxxOOxx flush 

PAG 


22 

OOOFOODO 

0 

-nov 

EAX.CRO 

PAG 


23 

OOOFOOD4 

A 

=AND 

EAX, *160000000 

PAG 


24 

000F00D8 

A 

-CMP 

EAX,**6000000b 

PAG 


26 

OOOFOOEO 

0 

JZ 

RAV_BN!D+000F00F2 

PAG 


30 

OOOFOOFO 

2 

JMP 

RAV_BN!D+OOOF01D2 

PAG 


34 

O00F01D0 

2 

MOV 

AX,CS 

PAG 


35 

OOOFOID-^ 

4 

MOV 

SS.AX 

PAG 
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Using the Symbol Utility 

To Display Symbols in the Trace List 


3 Select the base of the ADDR label. 

If you have loaded the OMF symbols into a label other than ADDR, select the 
base for that label. 

4 Choose Symbol from the base pop-up field. 


Set the base of the 
ADDR label to 
Symbol 









c 
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) ^Invasm Options) ( Print ) ( Run 
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j 


0 

RAViDATA+FFFFFFFO 

0 

jfip 

FOOOtEOSB 



4 

RAV_BN:DATA+FE058 

B 

jnp 

RAY-BN-D+OOOFOOBA 



8 

RAY BN^DATA+FOOBB 

A 

CLI 






B 

CLD 




9 

RAY-BNiDATA+FOOBC 

C 

IN 

AL,#64 





E 

TEST 

AL,#04 


c: 

16 

TrgGetExtRef+0032 

4 

xxxxxxOO i/o reed 



21 

SVriLOP. :pr 09+0001 

1 

xxxxOOxx flush 



22 

RAY-BNiDATA+FOODO 

0 

-nov 

EAX.CRO 



23 

RAY_BN:DATA+F00D4 

4 

=AND 

EAX.#60000000 



24 

RAY_BN!DATA4F00D8 

A 

"Cnp 

EAX.#60000000 



26 

RAY_BN:DATA+FOOEO 

0 

J2 

RAy_Bn!D+OOOFOOF2 



30 

RAY-BfJiDATA+FOOFO 

2 

JNP 

RAV_BN'D+000F0tD2 



34 

RAY_BNiDATA+FO1D0 

2 

nov 

AX.CS 


■ 

35 

RAY_BN!DATA+F01D4 

4 

nov 

SS.AX 

_j 


If you have created User Symbols that overlap with the OMF symbols, the User 
Symbols take precedence and will be displayed in the listing instead of the OMF 
symbols. 


iirr^ T JO 1 _ 1 - If . rv 

1 o ijoau a oyiuooi rue, on page z-6. 
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Using the Symbol Utility 

To Trigger on a Symbol 


To Trigger on a Symbol 


You must load a symbol file into the measurement module before you can 
trigger on OMF symbols. 

1 Go to the Trigger Menu. 

2 Set the base of the label that you want to specify a trigger term with 
to Symbol. 

Typically, you will use the ADDR label. 


Access the 
Trigger menu 


Set the base of the 
ADDR label to Symbol 


( 100/500I1HZ Lfl C ] ( Trigger 1 ] 




9 

0 


state Sequence 
Hhile storing "no state" 
TRIGGER on "a" 1 time 


Store "anystate" 


Timer 
i 2 


( firming1 
Control J 


( ficquisitionl 
Control J 


Coup t 
Time 


C1 ear 
Trigger 


(♦Label ♦) 

(fiDDR) f 





t a J 

( absolute XXXXXXXX") C 

( J 

( absolute XXXXXXXX] f 

( c ) 

( absolute XXXXXXXX]f 


( absolute XXXXXXXX] [ 


J [ CYCLE ) ( BE ) ( SIZE ) 


Hex [ Symbol C Symbol ) [ Symbol ) 
XXXXXXXX ) ( QPCOD ) ( absolu X] ( ~ ab X ) 

XXXXXXXX) [ absol X ) ( absolu x] [ ab X ) 

XXXXXXXX ) f absol X) ( absolu X ) [ ab X ) 

XXXXXXXX ) ( absol X ) ( absolu X ) [ ab X ) 
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Using the Symbol Utility 

To Trigger on a Symbol 


Select a trigger 
term 


3 Select a trigger term that you want to use. 

The trigger term is the field that corresponds to the term column on the left 
side of the display, and the label row in the center of the display. 

4 In the pop-up menu, select the User Symbol Table field Choose OMF 
Symbol Table. 



100/500nHZ LA 


^ ( Trigger 1 ] 


r 


9 

0 


state Sequence Levels 
Hhile storinn "nn state" _ 


Timer 
1 2 


TRIGGER on "a 


Store "any 


Label ») 


ft ♦ Terms ♦) 

LUD 


Syirt 


mm 


User Symbol Table 


OMF Symbol Table 


^ absol u ^ ab X ^ 
[ abso1u X ] ^ ab X ] 
absolute XXXXXXXX ) ( XXXXXXXX '] ( absol X) ( absolu x) [ ab X ) 


( Armin 
Centre 


I^Acquisi tion 
1 Control 

c 


Count 

Time 


Cl ear 
Trigger 


i 

( Symbol ] [ Symbol ] 
I absolu X 1 f ab X ^ 


Select this field and 
choose OMF 
Symbol Table 
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Using the Symbol Utility 

To Trigger on a Symbol 


5 Use the knob to scroll through the list of symbols and pick the one 
that you want. Select Done. 

The trigger term is now defined as one of your OMF symbols. 


Q' 


c 

onp Symbol Table 

D 




* 

J 


ti fli\SVML0P.X 



Si 8c ^ 

fliign to A Bytes 

D 



_pkObjectEntry 

TryGetExtRef 

NsGetExtRef 

Sym] opGelExtRef 

PkExtRef 

TryExtRef 

NsExtRef 

Syml opEx IRef 

symlopSetSeparators 

syml opSymbolToftscii 


c 

f Cancel ] 

( View Globals and Locals ] 

f Done 


1C 

.. 

.. JT . J MJ 


J 


Highlight the symbol 
that you want to use 


Select Done 


6 Use the symbol term in the trigger specification to trigger the logic 
analyzer. 


Symbol trigger term 



1 

(4 Labe 1 4) 

( fiDDR ) ( DATA ) ( CYCLE ) ( BE ] [ SIZE ) 

(♦ Terms ♦) 

( Symbol ][ Hex )( Symbol )[ Symbol ]( Symbol ) 


^bjexiNsGetExtRef ) ( XXXXXXXX ) ( OPCOD ) ( absolu X ] ( ab X ) 

t b J 

( absolute XXXXXXXX )( XXXXXXXX) ( absol X] fabsolu X ) C ab X ) 

t c J 

[■ absolute XXXXXXXX] ( XXXXXXXX) f absol X) ( absolu X] f ab X ] 

( ^ J 

(■ absolute XXXXXXXX ] f XXXXXXXX) (■ absol X ) f absolu x'j f ab X ] 
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Using the Symbol Utility 

To View a List of Symbol Files Currently Loaded into the System 


See Also 


To View a List of Symbol Files Currently Loaded into 
the System 


1 Access the OMF Symbol Load menu. 

There are two methods available to access this menu. See "To Access the 
Symbol File Load Menu" in Chapter 1 for more information. 

2 Select the Current Loaded Files field, in the bottom left comer of the 
display. 


Loaded Database Files 

Analyzer/Dachine Label File Type 


2nB Data Acq E 
Ai\SI000.6PA 
C:\S1000.NS 

; Labi 

; Genera! Purpose Ascii 

100/500nHz LA C 
Ci\RAV_BND.3B6 
C:\RAV_BND.NS 

; ADDR 

: 0riF3B6 

lOO/SOOMHz LA C 

i ADDR 

: IEEE-695 


A!\SVnL0P ,X 
C :\SYI1L0P ,NS 


( 


Delete 


3 


C 


Done 


3 


A list of the symbol files that are currently loaded is displayed. 
3 Select Done to return to the OMF Symbol Table menu. 

"To Access the Symbol File Load Menu" in Chapter 1. 
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Using the Symbol Utility 

To Remove a Symbol File From the System 


To Remove a Symbol File From the System 


1 Access the OMF Symbol Load menu. 

There are two methods available to access this menu. See "To Access the 
Symbol File Load Menu" in Chapter 1 for more information. 

2 Select the Current Loaded Files field, in the bottom left comer of the 
display. 

A list of the symbol files that are currently loaded is displayed. 

3 Highlight the measurement module and file name that you want to 
delete. 

4 Select Delete to remove the symbol file from the system. 

5 Select Done to return to the OMF Symbol Load menu. 


Highlight the file 
that you want to 
delete 


Select Delete to 
delete the file 


Loaded Database Files 

final yzer/tlachine Label File Type 


2I1B Data ficq E 
fi'XSIOOO.GPfi 
CiVSlOOO.NS 

: Labi 

■■ General Purpose fiscii 

100/500nHz Lfi C 
Ci\RfiY_BND.366 
Ci'vRfiV-BND.NS 

■ fiDDR 

: 0MF386 

lOO/SOOMHz Lfi C 
fi;\SVnLOP,X 

C:\SYnLOP,NS 

: fiDDR 

: IEEE-695 


,c 


View 


3 



ete 


3 


2-12 






3 



Features and Functions 



Features and Functions 


See Also 


The HP E2450A Symbol Utility adds two main menus to your logic 
analyzer. They are the Symbol File Load menu and the Symbol 
Browser menu. This chapter describes the features and functions of 
both of these menus. 

The symbol utility also provides a General-Purpose ASCII (GPA) 
symbol file format that you can use if your language tool chain does 
not produce OMF files in one of the supported formats. The details of 
the GPA file format are also described in this chapter. 


The Logic Analyzer Training Kit for information on how to use the 
logic analyzer interface. 

The User’s Guide of your logic analyzer for information on the features 
and functions of the logic analyzer. 
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The OMF Symbol File Load Menu 


The OMF Symbol Load menu is used to load the OMF files containing 
the symbols that you want into the logic analyzer. 


cz 

OMF Symbol Table 

ID 



OnF File: 





mm 



Drive: 

[ Flexible 

Disk ] 



Label: 

f ADDR 

) 







^Current Loaded Files ] 

i Load 1 

1 

Done 

1 



OMF Symbol File Load Menu 
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Features and Functions 

OMFFile Field 


OMFFUe Field 

The OMF File field is used to select the OMF file that you would like to load 
into the system. When you initially access the OMF Symbol Table menu, the 
OMF File field will be blank. To use this field, select it. A File Selection 
pop-up menu appears. The pop-up menu shows you a list of files at the root 
of the drive that is currently selected in the Drive field. ScroU the list of files 
to select the symbol file that you want to use. Use the Select field to choose 
the file, or to choose a subdirectory to browse through. Select Cancel to 
close the menu. 

Refresh Field 

The Refresh field causes the Symbol Utility to reread the contents of the disk 
drive. Changes made to the disk drive contents are not immediately read by 
the symbol utility. Use the Refresh key to re-read the disk drive contents if 
they have changed. 


Drive Field 

Use this field to specify the disk drive that contains the OMF file that you 
want to load. You can specify "Hard Disk" for the analyzer hard disk drive, or 
"Flexible Disk" for the analyzer flexible disk drive. 
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Features and Functions 

Label Field 


Label Field 

Use this field to specify the data label that the symbols will correspond to. In 
most cases you will use the ADDR label, since you will be loading symbols 
into the system that correspond to the address bits of the processor that you 
are working with. If you would like to load symbols that correspond to 
another label, select this field then choose the label that you want to use from 
the pop-up menu. 



Module Field 

Use this field to specify the measurement module of an HP 16500B/C that 
you want to load the OMF file symbols into. When you select this field you 
will see a pop-up menu listing the measurement modules that are currently 
installed in the PIP 16500 frame. For benchtop logic analyzers, this field is 
always Analyzer. Once the symbol file is loaded, you will be able to view the 
symbols in the Listing and Trigger menus of the m.odule that you speci^^ 

The OMF symbols will not be available in any other module than the one the 
is specified in the Module field. To view symbols in more than one module, 
specify a different module in the Module field and load the symbol file again. 
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Features and Functions 

Load Field 


Load Field 

Select this field to load the symbol file into the logic analyzer. During the 
load process, a symbol database file with a ".ns" extension will be created by 
the Symbol Utility. You can load multiple symbol databases into the system 
at the same time. One .ns database file wiU be created for each symbol file 
that you load. 

If the OMF symbol file is loaded from the hard disk drive, the .ns database file 
will be created on the same subdirectory that the OMF file is in. If the OMF 
file is loaded from the flexible disk drive, the directory path fi-om the flexible 
disk drive will be duplicated on the hard disk drive. The .ns database file will 
be created on the hard disk drive, in the same subdirectory that the OMF file 
was in on the flexible disk drive. 

Once the .ns file is created, the S 3 nnbol Utility wiU use this file as its working 
symbol database. The next time you need to load the symbols into the 
system, you can load the .ns file explicitly, by placing the .ns file name in the 
"OMF file" field. You can piirge the OMF file from the disk, once the .ns file is 
created. 

OMF file versions 

If you load an OMF file that has been loaded previously, the system wUl 
compare the time stamps on the .ns file and the OMF file. If the OMF file is 
newer than the existing .ns file, a new .ns file wfil be created and the old one 
wfil be overwritten. If the OMF file being loaded has not been updated since 
it was last loaded, the existing .ns file wiU be used. 

Multiple files 

You can load the same symbol file into several modules, and you can load 
multiple symbol files into one analyzer. Symbols from each of the files that 
you load wUl appear in the OMF Symbol Browser menu and can be used to 
create trigger terms for the logic analyzer. 
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Features and Functions 

Current Loaded Files Field 


Current Loaded Files Field 

Select this field to view a list of the symbol files that are currently loaded. 

The Loaded Database Files pop-up menu provides a Delete field that you can 
use to remove a symbol database from a measurement module. Use the knob 
to highlight the module and symbol file that you want to remove. Select the 
Delete field to remove the file. 



finalyzer/nachine 

Loaded Database 

Label 

Files 

File Type 

2riB Data ficq E 
fi:\S1000.GPfi 
C:\S1000.NS 

i Lab1 

General Purpose Ascii 

100/500MH2 Lfi C 

C ARfiY_BND.386 
C!\RfiV_BND.NS 

i ADDR 

i Df1F386 

lOO/SOOMHz Lfi C 
fiiYSVnLOP.X 
C!V.SVriLOP,NS 

: ADDR 

: IEEE-695 


I Delete j 


Current Loaded Files Display 


View Field 

The View field is used to select the database tliat you want to be work with in 
the OMF Symbol Table load menu. If more than one database has been 
loaded, you can choose the database that you want to work with by 
highlighting the analyzer and file name and selecting the View field. 


The file name that you select wiU appear in the OMF File field in the main 
OMF Symbol Table load menu. You can now change the file characteristics, 
such as the Section Relocation options. 
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Features and Functions 

Section Relocation Option 


Section Relocation Option 

The Section Relocation option allows you to add offset values to the symbols 
in an OMF file. Use this option if some of the sections or segments of your 
code is relocated in memory at run-time. This can occur if your system 
dynamically loads parts of your code, so that the memory addresses that the 
code is loaded into are not fixed. 

To use this option, highlight the memory section that you want to offset, then 
select the Select field. Choose one of the offset options described below. 

If you have loaded more than one symbol file, the Section Relocation option 
applies to whichever file is currently displayed in the OMF File field. To 
select a different file, use the View option in the Current Loaded Files menu. 


NamB 

Relocation of OMF nemory 

Address Space 

Sections 

Address 


const 

(unused) 

b34 


1 ibc 

(unused) 

b7a 


prog 

(unused) 

0 


OriF File: 

A:\SYnLOP.X 




f Select j 

( 

Done 1 






Section Relocation Menu 
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Features and Functions 

Section Relocation Option 


Set Absolute Section Location 

Use this option to set an absolute address for the start of the selected 
section, when you know the run-time address of the section. 

Offset This Section 

Use this option to add an offset to the start of the selected section, when you 
know the relocation offset of the section. The value entered will be added to 
the section address that was contained in the OMF file. All symbols falling 
within the address range of this section will be offset by this value. 

Offset All Sections 

This option adds an offset to the starting addresses of all sections in the 
selected OMF file. The values entered will be added to all relocatable 
sections in your program. You wiU typically use this option if you have PC 
relative code and data. 

A section that contains symbols for hardware addresses will usually be 
indicated as nonrelocatable in the OMF file. The symbols for these sections 
will not be relocated. 


3-9 




The OMF Symbol Browser Menu 


The OMF Symbol Browser menu allows you to browse through the symbols 
that have been loaded into a measurement module. You can use the symbols 
as trigger terms in the Trigger menu. Search features and wildcard 
characters are available to help you find the symbols that you want. 

Symbol Format 

The OMF symbols can be viewed in one of two formats: 

• as global and local variables, or 

• as source file names with line numbers. 

Select the large field at the bottom of the menu to toggle between the two 
modes. Symbols will appear in trace listings in the format selected here. 


ind ^ 


Context: 
Address ■ 


( OMF Symbol Table ] 


J 


( Align to 1 Byte ] Offset by (XXXXXXXx] 




^ Vien Globals and Locals j [ Done ] 


OMF Symbol Browser Menu 
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Features and Functions 

Symbol Type Selection Field (User vs. OMF) 


Symbol Type Selection Field (User vs. OMF) 

This field allows you to choose between the two types of symbols available in 
the logic analyzer. The choices are: 

• "User Symbols," corresponding to the symbols that you can define in the 

TTry-rmp-l- mo-mi onrl 

• "OMF Symbols," corresponding to the symbols in an OMF symbol file that 
you have loaded using the Symbol Utility. 

This field appears at the top of the pop-up menu, when you select a trigger 
term. 


G 


state Sequence Levels 
Hhile storing "no state" 

TRIGGER on "a 


0 

store "any 

offset 

User Symbol Table 




DtlF Symbol Table 


(■♦Label 
(♦Terms U 


Syrri 


absolute 


f absolute 


absolute 


Done ] 


G 

G 

Gi 

G 


Symbol Type Selection Pop-up 
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Features and Functions 

Find Field 


Find Field 

Use this field to locate particular symbols in the symbol databases that you 
would like to use in a trigger specification. When you first access the OMF 
Symbol Table menu, the Find field will display an asterisk (*). The asterisk is 
a wildcard character that you can use in browsing the symbol database for 
the symbol that you want. To begin using this field, select it, type in the 
name of a file or symbol, then select Done. When you type in a symbol name 
and select Done, the system searches the symbol database for symbols that 
match this name. 

Asterisk wildcard (*) 

The asterisk wildcard represents "any characters." When you perform a 
search on the symbol database using just the asterisk, you will see a list of all 
symbols contained in the database. The asterisk can also be added to a 
search word to find all symbols that begin or end with the same letters. 

Example To find all of the symbols that begin with the letters "st", select the Find field 

and type "st*". Select Done and the browse results look like this: 



Highlight the symbol that you want and select Done to use the symbol as a 
trigger term. 
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Features and Functions 

Find Field 


Question mark wildcard (?) 

If you are using a keyboard to control your logic analyzer, you can use the 
question mark wildcard character. A question mark represents "any single 
character." You can use more than one question mark in a symbol database 
search; for example, "?ector?num" is a valid search string. 

Example Your syTubol database contains many symbols that have names such as 

"syml," "syml7," and "sym20." To find all of the symbols that end in "5", 
select the Find field and type "sym?5". Select Done and the browse results 
look like this: 



select Done to use the symbol as a trigger term. 
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Features and Functions 

Browse Results Display 


Browse Results Display 

This area of the display shows you a list of the symbols that satisfy the search 
criteria that you have specified. Depending on the mode selected in the large 
field at the bottom of the display, the browse results display will show file 
names and fine numbers, or the symbol names. The field can be scrolled to 
view additional symbols that are offscreen. 

Scroll Files field 

This field appears if the symbol mode field, at the bottom of the screen, is set 
to "View Files and Line Numbers." Select this field to scroll the listing of the 
browse results. If this field is not selected, then the Line Number field can be 
scrolled. 
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Features and Functions 

Align to xx Byte Option 


Align to XX Byte Option 


Most processors do not fetch instructions from memory on bj^e boundaries. 
In order to trigger a logic analyzer on a symbol at an odd-numbered address, 
the address must be masked off. The "Align to Byte" option allows you to 
mask off an address. 



Example The symbol "main" occurs at address 1 OOF. The processor being probed is a 

68040, which fetches instructions on long word (4-byte) boundaries. In order 
to trigger on the address lOOF, the address must be masked off to the nearest 
4-byte boundary. The Align to Byte option would be set to "Align to 4 bytes." 
The Symbol Utility masks the address of the symbol "main" to lOOC hex 
before it is used as a trigger term. 
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Features and Functions 

Offset Option 


Offset Option 

The Offset option allows you to add an offset value to the starting point of the 
symbol that you want to use as a trigger term. You might do this in order to 
trigger on a point in a function that is beyond the preamble of the function, or 
to trigger on a point that is past the prefetch depth of the processor. Setting 
an offset helps to avoid false triggers in these situations. 

The offset specified in the Offset field is applied before the address masking 
is done by the "Align to xx Byte" option. 


Example An 80386 processor has a prefetch depth of 16 bytes. Functions fund and 

func2 are adjacent to each other in physical memory, with func2 following 
fund. In order to trigger on func2, without getting a false trigger from a 
prefetch beyond the end of fund, you need to add an offset value that is 
equal to or greater than the prefetch depth of the processor to your trigger 
term. In this case you want to add an offset of 16 bytes, so you would set the 
value of the "Offset by" field to 10 hex. When you specify func2 as your 
trigger term, the logic analyzer wiU trigger on address func2+10. 


3-16 



Features and Functions 

Context Display 


Context Display 

The Context display, just below the Find field, indicates the original OMF 
source file for the synibol that is currently highlighted in the Browse Results 
display. A: indicates the flexible disk drive. C: indicates the hard disk drive. 

Some OMF formats, such as IEEE-695, provide infoimation about the path 
name of the original source files. If you are using one of these OMF formats, 
you win see path information for the individual files in the browse results 
display. The source file path name is separated from the OMF path by a 
colon (:). 


Example An OMF file called symlop.x has been loaded from the hard disk drive of the 

HP 16500B. One of the source files for the OMF was called main.c. When 
you browse symbols from the symbol database, the context display might 
look like this: 

Context: C:\symlop.x:/users/fred/project/src/main.c 

C:\symlop.x is the path for the OMF file on the HP 16500B hard disk, 
/users/fred... is the path for the file main.c in the original environment where 
it was compiled. 


Address Display 

The Address display indicates the address corresponding to the symbol that 
is currently highlighted in the Browse Results display. The addresses are 
displayed as physical values. Intel 80x86 segmentioffset values are converted 
to physical address values before they are displayed. 




Features and Functions 

Symbol Mode Field 


Symbol Mode Field 

The OMF symbols can be viewed in one of two formats: 

• as global and local symbols, or 

• as source file names with line numbers 

Select the large field at the bottom of the display to toggle between the two 
modes. Symbols appear in the trace listing in the format that is selected here. 

When the "View Globals and Locals" mode is selected, the browse results are 
displayed as symbolic names. When the "View Files and line Numbers" mode 
is selected, the browse results display lists source file names from the OMF 
file. In the "View Files and Line Numbers" mode, two additional fields appear 
in the OMF Symbol Browser menu. 

The Scroll Files Field 

Select this field to assign the knob to scroll the Browse Results fisting. 

Line Number Field 

The Line Number field is used to select a fine number of a source file as a 
trigger term. Select the field once and it can be used to scroll through the 
fine numbers of valid, existing fines of code. Select the field a second time 
and a keypad pop-up allows you to specify a particular fine number. 

Not aU fines in a source file have code associated with them. When you type 
in a fine number that contains no code, the field defaults to the next highest 
fine number that does contain code. If you select a fine number higher than 
any fine number in the file, the field defaults to the highest fine number in the 
file. 
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The General-Purpose ASCII File Format 


The Symbol Utility supports a General-Purpose ASCII (GPA) file format. If 
your language tool chain does not produce one of the supported file types, 
you can create a GPA file to define symbols for the Symbol Utility. You can 
also use a GPA file to define symbols which are not included in a supported 
OMF file. 


Features and Functions 

Creating a GPA Symbol File 


Creating a GPA Symbol File 

You can create a GPA symbol file using any text editor that supports ASCII 
format text. Each entry in the file you create must consist of a symbol name 
followed by an address or address range. 

Each symbol name is a string of ASCII characters. The string can be very 
long, but the logic analyzer will truncate the string and use only the first 16 
characters. The address or address range corresponding to a given symbol is 
a hexadecimal number. The address must appear immediately on the same 
line of the text file as the symbol name. Addresses must be separated from 
symbol names by one or more blank spaces or tabs. Address can be specified 
as a single hexadecimal value, or as a range in the following format; 

beginning address..ending address 

It is possible to generate a GPA file from the symbol or load map output of 
most language tools. 

Simple Format 

A GPA file can be a simple list of name/address pairs. 


Example 

main 

00001000. 

.00001009 


test 

00001010. 

.OOOOIOIF 


varl 

00001E22 

#this 


This example defines two symbols that correspond to address ranges and one 
point symbol that corresponds to a single address. 
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GPA File Format 


GPA File Format 

A GPA file can be divided into records using record headers. The different 
records allow you to specify different kinds of symbols, with differing 
characteristics. A GPA file can contain any of the following kinds of records: 

• Sections 

• Functions 

• Variables 

• Source line numbers 

• Start address 

The different kinds of symbols available are e:5q)lained in the following 
sections. 

Each kind of symbol must be separated from the next by a key word, called a 
record header. The record headers must be enclosed in square brackets, like 
this: [HEADER]. If no record header is specified, the lines are assumed to be 
symbol definitions in one of the following VARIABLES formats: 

variable address 

variable start..end 

variable start address size 
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Features and Functions 

GPA File Format 


Example Here is a GPA file that contains several different kinds of records. 

[SECTIONS] 

prog 00001000..OOOOIOIF 

data 40002000..40009FFF 

common FFFFOOOO..FFFFIOOO 

[FUNCTIONS] 

main 00001000..00001009 

test 00001010..OOOOIOIF 

[VARIABLES] 

total 40002000 4 

value 40008000 4 

[SOURCE LINES] 

File: main.c 
10 00001000 

11 00001002 

14 OOOOIOOA 

22 OOOOIOIE 

File: test.c 
5 00001010 

7 00001012 

11 OOOOIOIA 
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Sections 


Format 

s e c tion_name 
start 
end 

attribute 


Example 


Sections 

[SECTIONS] 

section_naine start.. end attribute 

Use SECTIONS to define symbols for regions of miembry, such as sections, 
segments, or classes. 

A symbol representing the name of the section. 

The first address of the section, in hexadecimal. 

The last address of the section, in hexadecimal. 

(optional) Attribute may be one of the following; 

NORMAL (default) 

The section is a normal, relocatable section, such as code or data. 
NONRELOC 

The section contains variables or code that cannot be relocated. In other 
words, this is an absolute segment. 


To enable section relocation, section definitions must appear before any other 
definitions in the file. 


[SECTIONS] 

prog 

data 

display_io 


00001000..OOOOIFFF 
00002000..00003FFF 
00008000..0000801F NONRELOC 


If you use section definitions in a GPA symbol file, any subsequent function or 
variable definitions must fall within the address ranges of one of the defined 
sections. Those functions and variables that do notwill be ignored by the 
Symbol Utility. 






Features and Functions 

Functions 


Format 

func_name 

start 

end 


Example 


Functions 

[FUNCTIONS] 

func_name start..end 

Use FUNCTIONS to define symbols for program functions, procedures, or 
subroutines. 

A symbol representing the function name. 

The first address of the function, in hexadecimal. 

The last address of the function, in hexadecimal. 


[FUNCTIONS] 

main 00001000..00001009 

test 00001010..OOOOIOIF 
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Features and Functions 

Variables 


Format 


var_name 

start 

end 

size 


Example 


Variables 

[VARIABLES] 

var_naine start [size] 

var_naine start., end 

You can specify symbols for variables, using the address of the variable, the 
address and the size of the variable, or a range of addresses occupied by the 
variable. If you give only the address of a variable, the size is assumed to be 1 
byte. 

A symbol representing the variable name. 

The first address of the variable, in hexadecimal. 

The last address of the variable, in hexadecimal. 

(optional) The size of the variable, in bjrtes, in decimal. 


[VARIABLES] 

s-ubtotal 

total 

data_array 
sts.tu.s CiiS-ir 


40002000 4 

40002004 4 

40003000..4000302F 
40002345 
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Features and Functions 

Source Line Numbers 


Format 

file_name 
line# 
address 


Example 


Source Line Numbers 

[SOURCE LINES] 

File: file_name 
line# address 

Use SOURCE LINES to associate addresses with lines in your source files. 
The name of a file. 

The number of a line in the file, in decimal. 

The address of the source line, in hexadecimal. 


[SOURCE LINES] 


File: 

main, c 

10 

00001000 

11 

00001002 

14 

OOOOIOOA 

22 

OOOOIOIE 
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Features and Functions 

Start Address 


Start Address 

Format [START ADDRESS] 

address 

address The address of the program entry point, in hexadecimal 


Example [start address] 

00001000 


Comments 

Format # comment text 


Any text following a # character is ignored by the Symbol Utility and can be 
used to comment the file. Comments can appear on a line by themselves, or 
on the same line, following a symbol entry. 


Example 


#This is a coinment 
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Glossary 


benchtop logic analyzer A small, 
standalone HP logic analyzer that is 
not part of the HP 16500 logic analy¬ 
sis system. As of this edition, only 
the HP 1660C/CS-series and the 
HP 1670A/D-series can run the 
HP E2450A Symbol Utility. 

browser A pop-up menu which al¬ 
lows you to examine and select OMF 
symbols. 

data label A symbol which refers 
to an arbitrary value, much like the 
labels that are available in the logic 
analyzer without the Symbol Utility. 
AU other symbols refer to addresses. 
Data labels can be defined only in 
the General-Purpose ASCII symbol 
file format. 

database file The file created by 
the symbol utility and stored on the 
logic analyzer’s internal hard disk. 
The file is organized so that the Sym¬ 
bol Utility can efficiently look up the 
symbol associated with any address 
or label value. Database files have a 
".ns" file name extension. 

ELF/DWARF A portable OMF 
format consisting of the ELF 
(Executable and Linkable Format) 
and the DWARF (Debugging Infor¬ 
mation Format) for various 
processors, including Intel 80960, 
PowerPC, and MIPS. 


GPA The General-Purpose ASCII 
file format. These symbol files are 
created by the user, using an ASCII 
text editor. 

HP-MRI IEEE-695 The OMF 

format produced by HP and MRI 
cross-compilers and cross-assem¬ 
blers. This format is fuUy supported 
by the Symbol Utility’s IEEE-695 
reader. 

IEEE-695 A particular format for 
an OMF. This format is usually pro¬ 
duced by language tools for 
non-Intel microprocessors. SomiO 
language tools which claim to output 
this format may deviate from the 
IEEE-695 standard in ways which 
make the OMF file unreadable by the 
Symbol Utility’s reader. 

language tool chain A set of 

programs used to generate ex¬ 
ecutable code. For example, a 
compiler, assembler, and linker. 

loaded file A database file which 
has been loaded into the Symbol 
Utility. 

measurement module Any of the 

cards that can be inserted into the 
slots in the HP 16500 mainframe, 
such as an oscilloscope, pattern gen¬ 
erator, or logic analyzer. The HP 
E2450A Symbol Utility requires a 
logic analyzer measurement module 
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Glossary 


when run on an HP 16500 logic 
analysis system. 

OMF A file which contains mixed 
object code and symbol information. 
OMF stands for Object Module File. 
The OMF is produced by the lan¬ 
guage tool chain. 

OMF286 A particular format for 
an OMF. This format is usually pro¬ 
duced by language tools for Intel 
80x86 series and Pentium microproc¬ 
essors running in real or protected 
mode. 

OMF386 A particular format for 
an OMF. This format is usually pro¬ 
duced by language tools for Intel 
80x86 series and Pentium microproc¬ 
essors running in real or protected 
mode. 

OMF86 A particular format for an 
OMF. This format is usually pro¬ 
duced by language tools for Intel 
80x86 series and Pentium microproc¬ 
essors running in real mode only. 

OMF96 A particular format for an 
OMF. This format is usually pro¬ 
duced by language tools for the Intel 
80196 family of processors. 

point symbol A symbol that refers 
to a single address. 


procedure This term is used in 
the Symbol Utility to refer to proce¬ 
dures, functions, subroutines, or 
their equivalents. 

range symbol A symbol that re¬ 
fers to a range of addresses, such as 
a module or procedure. 

reader A program that generates a 
database file from a symbol file. 

symbol file A file which contains 
symbol information. This file is pro¬ 
duced by the language tool chain. 

TI-COFF A particular format for 
an OMF. This format is usually pro¬ 
duced by language tools for Texas 
Instruments nucroprocessors. 

user symbol table A table con¬ 
taining the symbols that are created 
by the user, using the Symbols op¬ 
tion in the Format menu. This is the 
standard symbol capability of the HP 
logic analyzer. 
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* character, 3-12 
? character, 3-13 
.ns files, 2^, 3-6 
loading; 3-6 

A 

accessing symbol utility menus 
browser menu, 1-10 
load menu, 1-6,1-8 
ADDR label, 2-3,2-7,3-5 
Address display, 3-17 
Intel 80x86 addresses, 3-17 
Align to Byte option, 3-15 
example, 3-15 
ASCII format 

See General-Purpose ASQI format 
assembling, 2-2 

B 

base, 2-7 to 2-8 
browser menu, 3-10 
accessing, 2-9 
using, 2-8 

browsing the symbol database, 3-12 
See also searching the symbol database 

C 

comments 

in General-Purpose ASCII format, 3-27 
compiling, 2-2 
Context display, 3—17 
example, 3-17 

creating an ASCII symbol file, 3-20 
creating OMF symbol files, 2-2 
Current Loaded Files field, 3-7 
Delete field, 3-7 
Delete option, 2-12 
using, 2-11 
View field, 3-7 

D 

data listing 
symbols in, 2-6 
database 

See symbol database 
Delete field, 3-7 
using, 2-12 


deleting symbol files, 2-12 
displaying OMF symbols, 2-6 
Drive field, 3-4 


F 

file names and line numbers, 3-10 
file versions, 3-6 
files and line numbers, 3-18 
line number field, 3-18 
valid line numbers, 3-18 
Find field, 3-12 


load menu, 3-3 
accessing, 1-6,1-8 
using, 2-3 

Loaded Database Files pop-up, 3-7 
loading a symbol file 
choosing a disk drive, 3-4 
choosing a file, 3-4 
choosing a label, 3-5 
choosing a measurement module, 3-5 
Load field, 3-6 

loading OMF symbol files, 2-3 



functions 

in General-Purpose ASCII format, 3-24 

G 

General-Purpose ASCn format, 3-2, 3-19 
address format, 3-20 
comments, 3-27 
creating a file, 3-20 
example, 3-22 
functions, 3-24 
record headers, 3-21 
sections, 3-23 
simple example, 3-20 
simple form, 3-20 
source fine numbers, 3-26 
start address, 3-26 
variables, 3-25 

generating OMF symbol files, 2-2 
globals and locals, 3-10,3-18 
GPA 

See General-Purpose ASCII format 

I 

installing 

software for logic analyzer, 1-3 

L 

label, 3-5 
setting base, 2-7 
Label field, 3-5 
Line Number field, 3-18 
fine numbers 
GPA file, 3-26 
linking, 2-2 
Load field, 3-6 


M 

masking off addresses, 3-15 
measurement modules, 2-3, 3-5 
choosing, 3-5 
Module field, 3-5 
multiple OMF files, 3-6 
loading, 2-4 

multiple symbol files, 3-6 

O 

odd-numbered addresses, 3-15 
Offest option of browser menu, 3-16 
example, 3-16 
offset 

adding to address values, 3-8 
aU sections, 3-9 
code section, 3-9 
trigger term, 3-16 
Offset All Sections option, 3-9 
Offset This Section option, 3-9 
OMF Ffie field, 3-4 
Refresh field, 3^ 
using, 2-4 
OMF Load field 
using, 2-4 
OMF symbol files 
creating, 2-2 
currently loaded, 2-11 
deleting, 2-12 

transferring to the HP 16500B system, 2-2 
versions, 3-6 
OMF Symbol Table 
browser menu, 3-10 
browser menu, accessing, 1-10, 2-9 
browser menu, using, 2-8 
load menu, accessing, 1-6 
load menu, using, 2-3 
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OMF Symbol Table menus, 3-2 
OMF symbols 
browsing, 1-10, 3-12 
loading into logic anals^zer, 1-6,2-3 
symbol type, 3-11 

P 

path name 
ofOMFffle, 3-17 
of source files, 3-17 
PC-relative code, 3-9 
prefetch, 3-15 
offsetting trigger term, 3-16 

B 

record headers, 3-21 
Refresh field, 3^ 
relocation of code, 3-8 
removing symbol files, 2-12 

S 

ScroU Files field, 3-14,3-18 
searching the symbol database, 3-12 
example, 3-12 to 3-13 
results, 3-14 

Section Relocation Option, 3-8 
Offset AU Sections option, 3-9 
Offset This Section option, 3-9 
Set Absolute Section Location option, 3-9 
sections 

in General-Purpose ASCII format, 3-23 
Set Absolute Section Location option, 3-9 
software 

installing for logic analyzer, 1-3 
software requirements 
for logic analyzer, 1-3 
source line numbers 
in General-Purpose ASCII format, 3-26 
start address 

in General-Purpose ASCII format, 3-26 
symbol base, 2-7 
symbol browser menu 
accessing, 1-10 
using, 2-8 
symbol database 
.ns files, 2-4 
creating, 3-6 


symbol file load menu, 3-3 
accessing, 1-6 
using, 2-3 

S3mibol format, 3-10 
choosing, 3-18 
symbol mode 
choosing, 3-18 

globals and locals vs. files and line 
numbers, 3-18 
symbol type, 3-11 
precedence, 2-7 
Symbol Utility software 
installing, 1-3 to 1-5 
symbols 
browsing, 3-12 

T 

trace listing 
symbols in, 2-6 
trigger term, 2-9,3-10 
triggering on a symbol, 2-8 
browser menu, 3-10 
finding the symbol you want, 3-12 
odd-numbered addresses, 3-15 

U 

User Symbols, 2-7,3-11 

V 

variables 

in General-Purpose ASCII format, 3-25 
versions of symbol files, 3-6 
View field, 3-7 

View Files and Line Numbers, 3-18 
valid line numbers, 3-18 
View Globals and Locals, 3-18 
viewing OMF symbols, 2-6 

W 

wildcard characters 
* character, 3-12 
? character, 3-13 
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